home *** CD-ROM | disk | FTP | other *** search
/ Amiga Magazin: Amiga-CD 1997 January & February / Amiga-CD 1997 #1-2.iso / aminet / 12_96 / lha-archiv / rcs_56.lha / rcs / README < prev   
Text File  |  1992-04-01  |  5KB  |  117 lines
  1.           
  2.           *********************************
  3.           RCS - The Revision Control System
  4.           *********************************
  5.           
  6. ------------
  7. What is RCS?
  8. ------------
  9. RCS is a set of tools which help you to maintain version control
  10. over files. RCS was originally intended for software source code,
  11. but it now can handle binary files as well. The various programs
  12. let you check in new revisions, checkout current or previous
  13. revisions, review revision histories, etc.
  14.  
  15. RCS was developed originally at Purdue University by Walter Tichy.
  16. It is intended mainly for Unix machines, but the function it
  17. performs is really vital for any software development environment.
  18.  
  19. For a good introduction to RCS, read the article by Bryce Nesbitt
  20. in the last issue of Amiga World Tech Journal (RIP). The rcsintro.doc
  21. file (in this archive) also shows some examples.
  22.  
  23. ------------
  24. This Version
  25. ------------
  26. This is the AMIGA port of version 5.6 of RCS, which I believe is the
  27. latest (the one that was on the Amiga World Tech Disk was 4.3).
  28. This version has several enhancements over the previous Amiga
  29. ports - see the RCS.README file. For the Amiga, I've added wildcard
  30. expansion. However, two items which the Amiga port does not use:
  31.  
  32. - GMT times - RCS normally logs the GMT time rather than the local
  33.   time for across-timezone coordination. I originally had this in
  34.   but it requires keeping timezone information in an environment
  35.   variable referenced by every commmand. This didn't seem worth it
  36.   so I reverted back to local time. I can put GMT back in if anyone
  37.   cares.
  38.   
  39. - Links - Although both AmigaDOS 2.0 and RCS support links, this port
  40.   does not handle links any differently than any other file. This is
  41.   mainly because most of the Unix-like link support / resolution 
  42.   routines are present in DICE or SAS yet, and I'm too lazy to come
  43.   up with my own. I'm sure something will change there - Either I will
  44.   not be so lazy, or DICE and SAS will put them in. (Actually, DICE
  45.   does have a start on this already).
  46.  
  47. ------------
  48. Requirements
  49. ------------
  50. This version of RCS requires AmigaDOS 2.0 or later. If you try to
  51. run it under an earlier version, you should just get an error
  52. message, and the program will exit.
  53.  
  54. ------------
  55. Installation
  56. ------------
  57. Just put everything in the bin directory here somewhere in your
  58. path. Put the doc files where ever you like. Note that many of the
  59. programs run the 'diff' program - so diff needs to also be some-
  60. where on your path. This is the latest diff from GNU (1.15) so
  61. is a pretty handy program by itself. Sorry, I don't have a man
  62. page for diff.
  63.  
  64. To use most of RCS, you need to set either LOGNAME or USER environ-
  65. ment variable to the your name (or whatever name you want RCS to
  66. long into the revision history). Example:
  67.  
  68.               setenv LOGNAME SNEVL
  69.  
  70. NOTE: You can copy env:LOGNAME to envarc:LOGNAME and it will be
  71. set for you automatically everytime you boot.
  72.  
  73. All of the executables are pure, so you can make them resident if
  74. you wish.
  75.  
  76. --------------
  77. rcsfreeze.rexx
  78. --------------
  79. This is an ARexx script I wrote to go along with the RCS programs.
  80. On Unix systems there is a shell script called 'rcsfreeze' which
  81. does the same thing. This script assigns a symbolic name to the
  82. current checked-in version of every file in the current directory.
  83. This lets you later recreate that exact baseline using only that
  84. symbolic name, even though all the files may have had different
  85. version numbers. If all of that doesn't make sense to you yet,
  86. wait 'til you work with RCS a while.
  87.  
  88. ------------
  89. Distribution
  90. ------------
  91. RCS is free software, distributed under the GNU Public License
  92. (GPL) from the Free Software Foundation. See the file COPYING for
  93. details of the GPL. The important things to note are: (1) There
  94. is no warranty for RCS, by me or FSF; (2) RCS is free; you can
  95. distribute it all you want (and you are encouraged to) but you
  96. can not charge except to recover your costs associated with the
  97. distribution; (3) I have not included the source code, but the
  98. source code is available from me. If you want it, send me a floppy
  99. and enough postage to return it to you. The source builds under
  100. either DICE (2.06.40) or SAS/C (5.10b).
  101.  
  102. ----------------------
  103. Bugs / Requests / Etc.
  104. ----------------------
  105. If you find a problem with any of the RCS stuff, report it to me
  106. as soon as you can. DO NOT report the problem to the Free Software
  107. Foundation. If there is a bug, it's probably from me. Even if you
  108. want to request a change or just say hi, I'd be happy to hear
  109. from you. If you want to request the source, you'll need to mail
  110. your disk to me. Otherwise, you can get ahold of me via EMail.
  111.  
  112.  
  113. Steve Anderson                 BIX:        snevl
  114. 1136 11th Street               Compuserve: 74375,1514
  115. Manhattan Beach, CA 90266      Genie:      S.ANDERSON11
  116.  
  117. I'm also on the AmigaSerV BBS from time to time: 310-983-1600